home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / progming / ldog114 / read.me < prev    next >
Text File  |  1993-02-02  |  14KB  |  364 lines
  1. 23NOV92
  2. Laughing Dog Screen Maker READ.ME file:
  3.  
  4.  This file contains any miscellaneous last minute information 
  5.  that did not make its way into the manual.
  6. ----------------------------------------------------------------------------
  7.  
  8. PRINTING THE DOCUMENTATION FILES:
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.     All of the Laughing Dog Screen Maker documentation files, having 
  11. the extension .DOC, are ready for printing.  They are already formatted
  12. using 1" margins and page breaks.
  13.     To print a file, use either the DOS copy command:
  14.                 
  15.             COPY LDOG.DOC LPT1
  16.  
  17.     or the DOS print spooler, which will allow you to run another
  18. application, while the document is printed in the background:
  19.  
  20.             PRINT LDOG.DOC
  21.  
  22.     Each file is described in the file PACKING.LST.  Most files are just
  23. a few pages long, with the exception of the Users Manual (LDOG.DOC), which
  24. is about 100 pages in length.
  25.  
  26. ---------------------------------------------------------------------------
  27. Instant Registration of the Laughing Dog Screen Maker via CompuServe
  28. ---------------------------------------------------------------------------
  29.  
  30. As a convience to those of you that have CompuServe accounts, you may now
  31. register the Laughing Dog Screen Maker instantly via CompuServe's Shareware
  32. Registration Service.
  33.  
  34. >>>It is not necessary that you download LDOG from CompuServe to use this
  35.    service. 
  36. >>>Registration Fee will be billed to your CompuServe account.
  37.  
  38. Here is how you do it:
  39. -- Just log on as usual, then at the ! prompt type "GO SWREG"
  40. -- You will then see the Register Shareware Menu.
  41. -- Choose "Register Shareware" or "Instructions to Register Shareware" for
  42.    more information.
  43. -- When you choose the "Register Shareware" option, you will be presented
  44.    with another menu allowing you to scan the registration database and
  45.    specify the program to register.
  46.  
  47. -- There are several options:               Search for:
  48.  
  49.       Registration ID                        344
  50.       Title                                  Laughing Dog Screen Maker
  51.       File Name                              LDOG.ZIP
  52.       Author's User ID                       73650,104
  53.       Author's Name                          Jeff Sloan
  54.       Keywords                               Laughing or Dog or Screen
  55.  
  56. --When you have located the description of the Laughing Dog Screen Maker,
  57.   just follow the directions to register it. The registration fee will be
  58.   automatically billed to your CompuServe account, and Yardbird Software
  59.   will be notified within 24 hours of your order, which will be shipped
  60.   the same or next day!
  61.  
  62. ---------------------------------------------------------------------------
  63. New Features that did not make it into manual:
  64. ---------------------------------------------------------------------------
  65.  
  66. --Added ASCII Text output to the Generate Code/Export Menu.  To use it,
  67.   select the ASCII Text File option from the Generate Code/Export menu.
  68.   You will be presented with another menu which allows you to choose the
  69.   line termination method (Carriage Return and Line Feed, or Carriage
  70.   Return Only) and change the Last Screen Row included in the file from
  71.   the default (whole screen). You then select the "Write Text File" option
  72.   to save the file. You will be presented with the standard Save File dialog
  73.   box to enter a filename. ASCII Text files are saved with the extension:
  74.   "TXT"
  75.   NOTE: The following characters are filtered out, as they will not print
  76.   out correctly in a text file:
  77.  
  78.   (Hexadecimal values): $07, $08, $09, $0A, $1A, & $1B.
  79.  
  80.   These values will be replaced with spaces ($20).
  81.  
  82.  
  83. --Added the ability to automatically insert WildCat! and PCBoard @variables
  84.   into a screen.  These are only of use to you if you are intending to export
  85.   the screen as a PCBoard or WildCat! BBS file.  To insert an @variable:
  86.   place the cursor at the position where you would like to insert the
  87.   @variable string.  Press the hot key: <cntl>-V.  You will be presented
  88.   with a menu allowing you to specify which BBS software you are using
  89.   (PCBoard or WildCat!). This setting only needs to be specified the
  90.   first time you enter an @variable during the current LDOG session, it will
  91.   be set as the default for any subsequent insertions.  You may also set
  92.   the method of coloring the string from this menu (this setting will also
  93.   be remembered for subsequent insertions).  The two choices are: 1. Use the
  94.   current color, that is, the color selected via the color attribute
  95.   selection box. or 2. Use the color at the cursor position.  Choose the
  96.   method you prefer.  NOTE: It is very important that the entire @variable
  97.   string be of the same color because if it is not, a color change @code will
  98.   be inserted into the middle of the @variable string when written to a file
  99.   causing the @variable to become corrupted.  Some @variables contain "fill"
  100.   characters that are to be filled in by you.  The filler character used is
  101.   the pound sign "#"  Replace the #'s with the appropriate numbers, USING THE
  102.   SAME COLOR AS THE REST OF THE @VARIABLE STRING!
  103.  
  104. --Also note that the last row of screens exported as WildCat! or PCBoard
  105.   BBS screens is truncated.  This will allow the screens to be displayed
  106.   correctly when the background is a color other than black.
  107.  
  108. ---------------------------------------------------------------------------
  109. Changes Made in the Manual
  110. ---------------------------------------------------------------------------
  111. --The PostScript output now contains a feature which allows you to easily
  112.   specify the number of printouts to produce from a single file. The line:
  113.        /#copies 1 def
  114.   tells the printer how many copies of the upcomming page to print.  Change
  115.   the "1" to any other positive integer to print multiple copies.
  116.  
  117. --The color Pascal code and mono Assembler source code produced by the 
  118.   Laughing Dog has been changed. The listings in the manual are no longer
  119.   correct. They should read:
  120.  
  121. ==============
  122.  Pascal Code:
  123. ==============
  124. { C:\LDOG\TEST.PAS -- Laughing Dog Screen Maker Pascal-Code file}
  125. { Created: 9/25/92 }
  126.  
  127. PROGRAM test;
  128. uses Crt, Dos;
  129.  
  130. VAR
  131.     ch : char;
  132.     Xpos : byte;
  133.     Ypos : byte;
  134.     ScnIndx : integer;
  135.     Regs : Registers;
  136.  
  137. CONST
  138.     ScnRows=25;
  139.     ScnCols=80;
  140.  
  141.     test_SCREEN : ARRAY [1..4000] OF byte = (
  142.         131, 196, 131, 196, 131, 196, 131, 196, 131, 196, 131,
  143. ...etc....
  144.         126, 219, 126, 219, 126, 219, 126, 219, 126, 219, 126,
  145.         126, 219, 126, 219, 126, 219, 126, 64, 126, 66, 126);
  146.  
  147. BEGIN
  148.     {Set-Up Vars}
  149.     ScnIndx := 1;
  150.     Xpos := 0;
  151.     Ypos := 0;
  152.  
  153.     {Main Loop}
  154.     repeat
  155.  
  156.         {Position cursor--> Interupt: $10, Function: $2}
  157.         Regs.AH := 2; {Func 2}
  158.         Regs.BH := 0; {Video Page 0}
  159.         Regs.DH := Ypos;
  160.         Regs.DL := Xpos;
  161.         Intr($10,Regs);
  162.  
  163.         {Write Char/Attr to Screen--> Interrupt: $10, Function $9}
  164.         Regs.AH := 9; {func 9}
  165.         Regs.AL := test_SCREEN[ScnIndx]; {char}
  166.         Regs.BH := 0; {video page 0}
  167.         ScnIndx := ScnIndx + 1;
  168.         Regs.BL := test_SCREEN[ScnIndx]; {attr}
  169.         Regs.CX := 1; {# chars}
  170.         Intr($10,Regs);
  171.  
  172.         {Point to Next Screen Pos & Char/Attr}
  173.         ScnIndx := ScnIndx + 1;
  174.         Xpos := Xpos + 1;
  175.         if Xpos = ScnCols then {end of row?}
  176.         begin {yes, wrap}
  177.             Xpos := 0;
  178.             Ypos := Ypos + 1;
  179.         end
  180.     until Ypos = ScnRows;
  181.     read(ch); {wait for a keystroke}
  182.     ClrScr; {clear the screen}
  183. END.
  184.  
  185. ======================
  186.  Mono Assembler Code:
  187. ======================
  188. ; C:\LDOG\TEST.ASM 
  189. ; -- Laughing Dog Screen Maker MASM Assembly-Code file
  190. ; Created: 9/25/92
  191.  
  192.  
  193. TEST_LENGTH    EQU    2000
  194.     .MODEL    small
  195.  
  196.     .STACK    100h        ;256 byte stack
  197.  
  198.     .DATA
  199.  
  200. TEST_SCREEN LABEL WORD
  201.  
  202.     DB    "This is the first line in the screen.....                  "
  203. ...etc...
  204.     DB    "and, this is the last line in the screen...                "
  205.  
  206.     .CODE
  207. ;STARTUP CODE (Set up DS, SS and SP Regs)
  208. dogstart:
  209.     mov    dx,@data
  210.     mov    ds,dx
  211.     mov    bx,ss
  212.     sub    bx,dx
  213.     shl    bx,1
  214.     shl    bx,1
  215.     shl    bx,1
  216.     shl    bx,1
  217.     cli
  218.     mov    ss,dx
  219.     add    sp,bx
  220.     sti
  221. ;Actual program begins here
  222.     push    es        ;save es register
  223.     mov    ah,0fh        ;get current video mode
  224.     int    010h
  225.     cmp    al,7        ;is it a monochrome mode?
  226.     jz    mono        ;yes
  227.     mov    ax,0B800h    ;color text video segment
  228.     jmp    SHORT setup
  229. mono:
  230.     mov    ax,0B000h    ;monochrome text video segment
  231. setup:
  232.     mov    es,ax        ;point to video memory
  233.     sub    di,di        ;zero indices
  234.     sub    si,si
  235. doit:
  236.     mov    al,[offset TEST_SCREEN+si] ;get ch
  237.     mov    ah,7        ;attr to use
  238.     mov    es:[di],ax    ;write to video memory
  239.     add    di,2        ;point to next pos in video memory
  240.     inc    si        ;point to next ch in array
  241.     cmp    si,TEST_LENGTH ;at end of screen?
  242.     jnz    doit        ;no, keep going
  243.  
  244.     mov    ah,02h        ;all done, hide cursor
  245.     mov    bh,0        ;assume video page 0
  246.     mov    dx,1A00h    ;moves cursor past bottom of screen
  247.     int    010h
  248.  
  249. ;wait for a keystroke
  250. lup:
  251.     mov    ah,1        ;function 1 (read kbd status)
  252.     int    016h        ;interrupt 16h
  253.     jz    lup
  254.     mov    ah,0        ;clear kbd buffer
  255.     int    016h
  256.  
  257. ;Clear the screen
  258.     mov    ah,6        ;function 6 (scroll window up)
  259.     mov    al,0        ;blank screen
  260.     mov    bh,7        ;use mono attribute
  261.     mov    ch,0        ;starting row
  262.     mov    cl,0        ;starting column
  263.     mov    dh,25        ;ending row
  264.     mov    dl,80        ;ending column
  265.     int    10h        ;call interrupt 10h
  266.  
  267.     mov    ah,02h        ;puts cursor back where it belongs
  268.     mov    bh,0        ;assume video page 0
  269.     mov    dx,0
  270.     int    010h
  271.  
  272. ;DOS exit function w/exitcode = 0
  273.     mov    ax,4c00h
  274.     int    21h
  275.  
  276.     END dogstart
  277.  
  278. ==================
  279. End source code
  280. ==================
  281.  
  282. ---------------------------------------------------------------------------
  283. Command Line Switch added to LDOGSHOW.EXE
  284. ---------------------------------------------------------------------------
  285. There is a new command line option (switch) which has been added which may
  286. be useful. It is:
  287.     /X         exit program with screen intact (don't clear screen)
  288.  
  289. If a single screen is being displayed, LDOGSHOW will simply terminate,
  290. leaving the screen displayed. It will not require a keystroke, and it will
  291. not clear the screen.
  292. If multiple screens are being displayed via the /L listfile.ext option,
  293. the list will not continually loop, but will instead simply end upon
  294. displaying the last screen in the list. It will not wait for a keystroke
  295. after the last screen, and it will not clear the screen.
  296.  
  297. ---------------------------------------------------------------------------
  298. BONUS PostScript UTILITY ADDED AT LAST MINUTE!
  299. ---------------------------------------------------------------------------
  300. The file BLK2EPS.EXE is a utility program which will convert a block file
  301. into an EPS (PostScript) file.  The resulting file may be imported into
  302. other programs accepting EPS files just like the full screen EPS files
  303. produced by the Laughing Dog Screen Maker.
  304.  
  305. USAGE:
  306.     BLK2EPS infile.PUP outfile.ext NeedFont?
  307.  
  308.     Where infile.PUP is the full filename of the block file to convert,
  309.     outfile.ext is the full filename of the resulting EPS file (recommend
  310.     using the EPS extension), and NeedFont? is the digit 0 or 1 (1=include
  311.     font information in EPS file, 0=DO NOT include font).
  312.  
  313. EXAMPLE:
  314.     BLK2EPS BLOCK1.PUP BLOCK1.EPS 1
  315.  
  316.     This example will take the file "BLOCK1.PUP" in the current directory
  317.     and convert it to an EPS file including the font, and save the new
  318.     file as "BLOCK1.EPS" in the current directory.
  319.  
  320. NOTE: You may also convert a full screen xxxxxxxx.DOG file to EPS using this
  321.       utility.
  322.  
  323. -----------------------------------------------------------------------------
  324.  Mind Boggling Example of what can be done with the IBM extended chars!
  325. -----------------------------------------------------------------------------
  326.     Check out this file: MAGIC.DOG
  327.     I found it originally as ANSI art on a local BBS, and I haven't been
  328. the same since.  I didn't know such things were possible!  This is just an
  329. example of the fantastic images you can create using the Laughing Dog Screen
  330. Maker (NOTE: MAGIC.DOG was not created with LDOG, it was captured from the 
  331. original ANSI using LDOGRAB.EXE)
  332.  
  333. -----------------------------------------------------------------------------
  334.  Attention BBS SYSOPS! -- New program for Wildcat! or PCBoard BBS Sysops
  335.                           from Yardbird Software.
  336. -----------------------------------------------------------------------------
  337. >>  WCView -- Wildcat! BBS screen @code screen file viewer.  This program
  338.               allows you to view @code screens with any embedded @variable
  339.               codes like @USER@, @CITY@, etc. automatically replaced by
  340.               text which you can specify.  View individual or multiple
  341.               screens. Toggle between color and monochrome views of your
  342.               screens. Change replacement text by simply editing a text file.
  343.               Program reacts to your input keystrokes and embedded screen
  344.               control codes like @PAUSE@, etc. EXACTLY as the BBS software
  345.               does!  You can now preview screens offline.  A great companion
  346.               program to The Laughing Dog Screen Maker!
  347.  
  348. >>  PCBView -- Same as WCView for PCBoard BBS @code screens.
  349.  
  350.   Look for:    WCVIEW.ZIP or PCBVIEW.ZIP on your local BBS, CompuServe, or
  351.                GEnie (in the BBS forum/roundtable software libraries).
  352.  
  353.   Keywords:    WILDCAT WCVIEW PCBOARD PCBVIEW BBS SCREEN @CODE
  354.  
  355.   If you can't find on a BBS, send $10 + $3(s&h) [California residents add 
  356.   $0.83 to cover sales tax] check, cash, or money order direct to:
  357.      Yardbird Software
  358.      PO Box 4646
  359.      West Hills CA 91308
  360.  
  361.  --sorry, at this low price, we can't send out evaluation copies for free,
  362.    but would be glad to send one if you send us $5 to cover disk, shiping,
  363.    and handling.
  364.